home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat7 / atm.z / atm
Encoding:
Text File  |  2002-10-03  |  5.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. AAAATTTTMMMM((((7777MMMM))))                                                                AAAATTTTMMMM((((7777MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      atm, quadoc3 - IRIS ATM OC-3c drivers
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      atm - driver for Challenge/Onyx OC-3c ATM interface
  13.      quadoc3 - driver for SGI XIO 4-Port OC-3c ATM interface
  14.      #include <sys/atm.h>
  15.      #include <sys/atm_user.h>
  16.      /hw/atm/*
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      These drivers control the SGI OC-3c ATM interfaces and provides an API to
  20.      the ATM AAL5 adaptation layer.  The driver supports rate controlled
  21.      constant bit-rate transmission of data.  The driver supports both
  22.      permanent virtual circuits (PVCs) and switched virtual circuits (SVCs).
  23.      The driver uses ATM Forum UNI-3.0/3.1 compliant signalling to establish
  24.      switched virtual circuits.
  25.  
  26.      Each time an application opens a device special file, ////hhhhwwww////aaaattttmmmm////****,,,, the
  27.      driver creates a clone device for that file descriptor.  The file
  28.      descriptor is bound to a virtual circuit using one of three mechanisms:
  29.  
  30.      An application binds a file descriptor to a permanent virtual circuit
  31.      (PVC) using the AAAATTTTMMMMIIIIOOOOCCCC____CCCCRRRREEEEAAAATTTTEEEEPPPPVVVVCCCC ioctl.  The file descriptor is then used
  32.      to transmit and/or receive data on the virtual circuit with the VPI/VCI
  33.      identifiers given in the ioctl's parameters.
  34.  
  35.      An application binds a file descriptor to a switched virtual circuit
  36.      (SVC) by using the AAAATTTTMMMMIIIIOOOOCCCC____SSSSEEEETTTTUUUUPPPP ioctl.  This ioctl a request to the ATM
  37.      network to set up a connection to an ATM end-point with a specified ATM
  38.      address.  If the connection set-up is successful, the ioctl call returns
  39.      without error and the file descriptor is bound to the resulting virtual
  40.      circuit.  An application can then use the file descriptor to transmit and
  41.      receive data on the virtual circuit.  If the connection set-up is not
  42.      successful, the ioctl returns with errno set to EEEEIIIIOOOO and the rrrreeeejjjjeeeecccctttt field
  43.      of the set up request contains the reason for failure.
  44.  
  45.      An application receives ATM switched virtual circuit set-up requests
  46.      using the AAAATTTTMMMMIIIIOOOOCCCC____RRRREEEEGGGGIIIISSSSTTTTEEEERRRR and AAAATTTTMMMMIIIIOOOOCCCC____LLLLIIIISSSSTTTTEEEENNNN ioctls.  For each call
  47.      request that comes in, the application can accept the call request and
  48.      bind the resulting switched virtual circuit to a file descriptor with an
  49.      AAAATTTTMMMMIIIIOOOOCCCC____AAAACCCCCCCCEEEEPPPPTTTT ioctl.  Alternatively, the application can reject an
  50.      incoming call request with the AAAATTTTMMMMIIIIOOOOCCCC____RRRREEEEJJJJEEEECCCCTTTT ioctl.
  51.  
  52.      For every write call performed on a file descriptor bound to a transmit
  53.      VC, the driver forms one or more AAL5 PDU's from the data and transmits
  54.      them over that VC.  The buffer in a write call must be aligned on an 8-
  55.      byte boundary.  For non-blocking writes (when the O_NDELAY flag is used
  56.      when opening the file descriptor), the application must lock down the
  57.      buffer in physical memory using the mmmmppppiiiinnnn((((2222)))) system call.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. AAAATTTTMMMM((((7777MMMM))))                                                                AAAATTTTMMMM((((7777MMMM))))
  71.  
  72.  
  73.  
  74.      For blocking writes, the write call returns after all the data has been
  75.      buffered on the interface.  But, a write call can complete before the
  76.      data is completely transmitted (especially at slow transmit rates).
  77.  
  78.      When a file descriptors is bound to a receiving VC, the interface sends
  79.      all PDUs received on that VC up to the application.  Received PDUs are
  80.      buffered in the kernel in per-VC queues.  It is the responsibility of the
  81.      application to perform enough read() calls to consume the data.  If the
  82.      per-VC receive queue in the kernel overflows, PDUs will be dropped.
  83.      Cells received on non-active VCs are discarded by the ATM interface.
  84.  
  85.      An application destroys a transmit VC by closing the corresponding file
  86.      descriptor.  But, the VC will remain active on the interface until all
  87.      data buffered for transmit over that VC is completely transmitted.
  88.  
  89. BBBBUUUUGGGGSSSS
  90.      If an application closes a transmit PVC and then quickly attempts to
  91.      reestablish the same PVC, the previous incarnation of the PVC will still
  92.      be active if it is still transmitting data.  The PVC will be available
  93.      again after all the data from the previous incarnation of the PVC has
  94.      been transmitted.
  95.  
  96. FFFFIIIILLLLEEEESSSS
  97.      /etc/init.d/atm
  98.      /usr/include/sys/atm.h
  99.      /usr/include/sys/atm_user.h
  100.      /var/sysgen/master.d/atm (Challenge and Onyx)
  101.      /var/sysgen/master.d/quadoc3 (Origin and Onyx2)
  102.      /hw/atm/*
  103.  
  104. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  105.      if_atm(7M), if_atmarp(7M), atmarp(1M), atmconfig(1M), atmilmid(1M),
  106.      atmsigd(1M), atmstat(1M), atmtest(1M), ifatmconfig(1M), sigtest(1M)
  107.      spansd(1M), mpin(2)
  108.      Silicon Graphics' ATM-OC3c API Programmer's Guide
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.